Inside Macintosh: QuickDraw GX Printing /

Chapter 2 - Core Printing Features / Core Printing Features Reference

Functions / Displaying the Page Setup and Print Dialog Boxes

GXJobDefaultFormatDialog

You can use the GXJobDefaultFormatDialog function to display the Page Setup dialog box.

gxDialogResult GXJobDefaultFormatDialog (gxJob aJob,
                              gxEditMenuRecord *anEditMenuRecord);

aJob

A reference to the job object whose default format you are allowing the user to modify.

anEditMenuRecord

A pointer to the Edit menu structure.

function result

The user's response to the dialog box.

DESCRIPTION

After you use the GXJobDefaultFormatDialog function to display the Page Setup dialog box, the user can specify formatting information for the default format. For example, the user can specify the paper size, orientation, and the default formatting printer.

In the anEditMenuRecord parameter you specify an Edit menu structure to support the standard editing operations of cut, copy, paste, and clear in dialog boxes.

The function returns gxOKSelected if Format is chosen or gxCancelSelected if Cancel is chosen.

If an error occurs, the function returns gxCancelSelected. Call the GXGetJobError function to determine which error occurred.

This function causes QuickDraw GX to send the gxJobDefaultFormatDialog message, which you can override to customize the Page Setup dialog box.

Note that QuickDraw GX stores a user's responses to some dialog items in the Page Setup dialog box in a format collection.

RESULT CODES

gxSegmentLoadFailedErr

A required code segment could not be found, or there was not enough memory to load it.

SEE ALSO

Listing 2-14 on page 2-36 shows how to use the GXJobDefaultFormatDialog function to display the Page Setup dialog box.

The Edit menu structure is described on page 2-48.

The dialog box result enumeration is described on page 2-48.

The format collection is discussed in the chapter "Page Formatting and Dialog Box Customization" in this book.

Main | Page One | What's New | Apple Computer, Inc. | Find It | Contact Us | Help